home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1996 May: Tool Chest / Developer CD Series May 1996 (Tool Chest) (Apple Computer) (1996).iso / Sample Code / Snippets / Interapplication Communication / Simple HLE / HLE.c next >
Encoding:
C/C++ Source or Header  |  1995-02-10  |  17.5 KB  |  530 lines  |  [TEXT/MPS ]
  1. /* A simple (real simple) High Level Event sample */
  2. #include <Types.h>
  3. #include <memory.h>
  4. #include <Packages.h>
  5. #include <Errors.h>
  6. #include <quickdraw.h>
  7. #include <fonts.h>
  8. #include <dialogs.h>
  9. #include <windows.h>
  10. #include <menus.h>
  11. #include <events.h>
  12. #include <OSEvents.h>
  13. #include <Desk.h>
  14. #include <diskinit.h>
  15. #include <OSUtils.h>
  16. #include <resources.h>
  17. #include <toolutils.h>
  18. #include <AppleEvents.h>
  19. #include <EPPC.h>
  20. #include <GestaltEqu.h>
  21. #include <PPCToolbox.h> 
  22. #include <Processes.h>
  23.  
  24. /* prototypes */
  25. void DoDiskEvents(long dinfo);                              /* hi word is error code, lo word is drive number */
  26. void DrawMain(WindowPtr drawIt);
  27. Boolean DoSelected(long val);
  28. pascal Boolean MyGenericFilter(Ptr myData,HighLevelEventMsgPtr theBuffer,const TargetID *sender);
  29. void SendHLE(void);
  30. void InitAEStuff(void);
  31. void DoHighLevel(EventRecord *AERecord);
  32. void DoDaCall(MenuHandle themenu, long theit);
  33. pascal OSErr AEOpenHandler(AppleEvent *messagein, AppleEvent *reply, long refIn);
  34. Boolean BrowseForMe(void);
  35. pascal OSErr AEOpenDocHandler(AppleEvent *messagein, AppleEvent *reply, long refIn);
  36. pascal OSErr AEPrintHandler(AppleEvent *messagein, AppleEvent *reply, long refIn);
  37. pascal OSErr AEQuitHandler(AppleEvent *messagein, AppleEvent *reply, long refIn);
  38.  
  39. ProcessSerialNumber gOurSN;
  40.  
  41. #define kMBarID 128
  42. #define kAppleMenu 128
  43. #define kFileMenu 129
  44. #define kEditMenu 130
  45. #define kToolsMenu 131
  46. #define kSendButton 128
  47. #define kResumeMask             1       /* bit of message field for resume vs. suspend */
  48. #define kBadCombo 129
  49. #define kNoFind 130
  50. #define kSearch 200
  51. #define kFirstEvent 'MYEV'
  52. #define kSecondEvent '2YEV'
  53. MenuHandle gAppleMenuHandle, gFileMenuHandle, gEditMenuHandle, gToolMenuHandle;
  54. Handle gMymenu;                                             /* my menu bar handle */
  55. ControlHandle sendButton;
  56.  
  57. typedef struct MyHLEGetter{
  58. short whichData;
  59. Ptr specificData;
  60. }MyHLEGetter;
  61.  
  62. enum{kMessageField =1,kRawData,kRefCon};
  63.  
  64. AEAddressDesc targetAddress;                                /* address of the person to get the data from */
  65.  
  66. TargetID theID,theID2;
  67. Boolean gQuit, gInBackground;
  68. EventRecord gERecord;
  69. AEDesc gTheAddress;
  70. WindowPtr myWindow;
  71. LocationNameRec theLoc;
  72. PortInfoRec theRec;
  73. PPCPortRec myPortName;
  74. LocationNameRec myLoc;
  75. PPCPortRefNum gPortRef = 0;
  76. PPCParamBlockRec myParamBlock;
  77.  
  78. GetSpecificFilterUPP gGetSpecificFilterUPP; /* filter for GetSpecificHighLevelEvent */
  79.  
  80.  
  81. Str255 displayString;
  82.  
  83. #ifdef powerc
  84.    QDGlobals    qd;
  85. #endif
  86.  
  87. main()
  88. {
  89.     WindowPtr twindow;
  90.     ControlHandle returnedControl;
  91.     MaxApplZone();
  92.     InitGraf((Ptr)&qd.thePort);
  93.     InitFonts();
  94.     InitWindows();
  95.     InitMenus();
  96.     TEInit();
  97.     InitDialogs(nil);
  98.     InitCursor();
  99.     
  100.     InitAEStuff();
  101.     
  102.     /* create the UPP for the filter to GetSpecificHighLevelEvent */
  103.     gGetSpecificFilterUPP = NewGetSpecificFilterProc(MyGenericFilter);
  104.     
  105.     /* set up my menu junk */
  106.     gMymenu = GetNewMBar(kMBarID);
  107.     SetMenuBar(gMymenu);
  108.     gAppleMenuHandle = GetMenuHandle(kAppleMenu);
  109.     gFileMenuHandle = GetMenuHandle(kFileMenu);
  110.     gEditMenuHandle = GetMenuHandle(kEditMenu);
  111.     gToolMenuHandle = GetMenuHandle(kToolsMenu);
  112.     AppendResMenu(gAppleMenuHandle, 'DRVR');
  113.  
  114.     
  115.    
  116.      DrawMenuBar();
  117.     myWindow = GetNewWindow(128, nil, (WindowPtr)-1);
  118.  
  119.     do {
  120.         WaitNextEvent(everyEvent, &gERecord, 30, nil);
  121.         switch (gERecord.what) {
  122.             
  123.             case nullEvent:
  124.                 /* no nul processing in this sample */
  125.                 break;
  126.             case updateEvt:
  127.                 DrawMain((WindowPtr)gERecord.message);      /* draw whatever window needs an update */
  128.                 break;
  129.             case mouseDown:
  130.                 /* first see where the hit was */
  131.                 switch (FindWindow(gERecord.where, &twindow)) {
  132.                     
  133.                     case inDesk:                            /* if they hit in desk, then the process manager */
  134.                         break;                              /* will switch us out, we don't need to do anything */
  135.                     case inMenuBar:
  136.                         DoSelected(MenuSelect(gERecord.where));
  137.                         break;
  138.                         
  139.                     case inSysWindow:
  140.                         /* pass to the system */
  141.                         SystemClick(&gERecord, twindow);
  142.                         break;
  143.                     case inContent:
  144.                         GlobalToLocal(&gERecord.where);
  145.                         /* track my button as needed */
  146.                         if (FindControl(gERecord.where, twindow, &returnedControl)) {
  147.                             if (TrackControl(returnedControl, gERecord.where, nil)) {
  148.                                
  149.                             }
  150.                         }
  151.                         break;
  152.                     case inDrag:
  153.                         if (twindow == FrontWindow())
  154.                             DragWindow(twindow, gERecord.where, &qd.screenBits.bounds);
  155.                         break;
  156.                     case inGrow:
  157.                     case inGoAway:
  158.                         /* don't care */
  159.                         break;
  160.                         
  161.                 }
  162.             case mouseUp:
  163.                 /* don't care */
  164.                 break;
  165.                 /* same action for key or auto key */
  166.             case keyDown:
  167.             case autoKey:
  168.                 if (gERecord.modifiers & cmdKey)
  169.                     DoSelected(MenuKey(gERecord.message & charCodeMask));
  170.                 break;
  171.             case keyUp:
  172.                 /* don't care */
  173.                 break;
  174.             case diskEvt:
  175.                 /* I don't do anything special for disk events, this just passes them */
  176.                 /* to a function that checks for an error on the mount */
  177.                 DoDiskEvents(gERecord.message);
  178.                 break;
  179.             case activateEvt:
  180.                 if (gERecord.modifiers & activeFlag)
  181.                     DrawMain((WindowPtr)gERecord.message);
  182.                 break;
  183.             case networkEvt:
  184.                 /* don't care */
  185.                 break;
  186.             case driverEvt:
  187.                 /* don't care */
  188.                 break;
  189.             case app4Evt:
  190.                 switch ((gERecord.message >> 24) & 0x0FF) {     /* high byte of message */
  191.                     case suspendResumeMessage:              /* suspend/resume is also an activate/deactivate */
  192.                         gInBackground = (gERecord.message & kResumeMask) == 0;
  193.                         break;
  194.                 }
  195.                 break;
  196.                 case kHighLevelEvent:
  197.                 /* This dispatches high level events (AppleEvents, for example) */
  198.                 /* to our dispatch routine.  This is NEW in the event loop for */
  199.                 /* System 7 */
  200.  
  201.                 DoHighLevel(&gERecord);
  202.                 break;
  203.             default:
  204.                 break;
  205.     
  206.                 
  207.         }
  208.     } while (gQuit != true);
  209.     
  210.     
  211. }
  212.  
  213. /* DoDaCall opens the requested DA.  It's here as a seperate routine if you'd */
  214. /* like to perform some action or just know when a DA is opened in your */
  215. /* layer.  Can be handy to track memory problems when a DA is opened */
  216. /* with an Option-open */
  217. void DoDaCall(MenuHandle themenu, long theit)
  218. {
  219.     long qq;
  220.     char DAname[255];
  221.     GetMenuItemText(themenu, theit, &DAname);
  222.     qq = OpenDeskAcc(DAname);
  223. }
  224.  
  225. /* end DoDaCall */
  226.  
  227. /* DoDiskEvents just checks the error code from the disk mount, */
  228. /* and puts up the 'Format' dialog (through DIBadMount) if need be */
  229. /* You can do much more here if you care about what disks are */
  230. /* in the drive */
  231. void DoDiskEvents(long dinfo)                               /* hi word is error code, lo word is drive number */
  232. {
  233.     short hival, loval, tommy;
  234.     Point fredpoint =  {
  235.         40, 40
  236.     };
  237.     hival = HiWord(dinfo);
  238.     loval = LoWord(dinfo);
  239.     if (hival != noErr)                                     /* something happened */ {
  240.         tommy = DIBadMount(fredpoint, dinfo);
  241.     }
  242. }
  243.  
  244. /* draws my window.  Pretty simple */
  245. void DrawMain(WindowPtr drawIt)
  246. {
  247.     BeginUpdate(drawIt);
  248.     SetPort(drawIt);
  249.     EraseRect(&drawIt->portRect);
  250.     MoveTo(20,20);
  251.     DrawString("\pData passed:");
  252.     if(displayString[0]){
  253.     DrawString(displayString);
  254.     } else {
  255.     DrawString("\p no data sent yet ");
  256.     }
  257.     EndUpdate(drawIt);
  258. }
  259.  
  260. /* my menu action taker.  It returns a Boolean which I usually ignore, but it */
  261. /* mught be handy someday */
  262. Boolean DoSelected(long val)
  263. {
  264.     short loval, hival;
  265.     Boolean temp = false;
  266.     loval = LoWord(val);
  267.     hival = HiWord(val);
  268.     
  269.     switch (hival) {                                        /* switch off the menu number selected */
  270.         case kAppleMenu:                                    /* Apple menu */
  271.             if (loval != 1) {                               /* if this was not About, it's a DA */
  272.                 DoDaCall(gAppleMenuHandle, loval);
  273.             } else {
  274.                 Alert(128, nil);                            /* do about box */
  275.             }
  276.             break;
  277.         case kFileMenu:                                     /* File menu */
  278.             gQuit = true;                                   /* only  item */
  279.             break;
  280.         case kEditMenu:
  281.             /* edit menu junk */
  282.             /* don't care */
  283.             break;
  284.          case kToolsMenu:
  285.         /* add all your test stuff here */
  286.         
  287.         SendHLE();
  288.         
  289.         break;
  290.        
  291.     }
  292.     HiliteMenu(0);
  293. }
  294.  
  295. /* InitAEStuff installs my appleevent handlers */
  296. void InitAEStuff(void)
  297. {    
  298.     OSErr aevtErr = noErr;
  299.     long aLong = 0;
  300.     Boolean gHasAppleEvents = false;
  301.     /* Check this machine for AppleEvents.  If they are not here (ie not 7.0)
  302.     *   then we exit */
  303.     gHasAppleEvents = (Gestalt(gestaltAppleEventsAttr, &aLong) == noErr);
  304.     /* The following series of calls installs all our AppleEvent Handlers.
  305.     *   These handlers are added to the application event handler list that 
  306.     *   the AppleEvent manager maintains.  So, whenever an AppleEvent happens
  307.     *   and we call AEProcessEvent, the AppleEvent manager will check our
  308.     *   list of handlers and dispatch to it if there is one.
  309.     */
  310.     if (gHasAppleEvents) {
  311.          aevtErr = AEInstallEventHandler(kCoreEventClass, kAEOpenApplication, 
  312.              NewAEEventHandlerProc(AEOpenHandler),0, false);
  313.              if (aevtErr)  ExitToShell();
  314.  
  315.          aevtErr = AEInstallEventHandler(kCoreEventClass, kAEOpenDocuments, 
  316.              NewAEEventHandlerProc(AEOpenDocHandler),0, false);
  317.              if (aevtErr)  ExitToShell();
  318.  
  319.          aevtErr = AEInstallEventHandler(kCoreEventClass, kAEQuitApplication, 
  320.              NewAEEventHandlerProc(AEQuitHandler), 0, false);
  321.              if (aevtErr)  ExitToShell();
  322.  
  323.          aevtErr = AEInstallEventHandler(kCoreEventClass, kAEPrintDocuments, 
  324.              NewAEEventHandlerProc(AEPrintHandler),0, false);
  325.              if (aevtErr)  ExitToShell();
  326.          
  327.        } 
  328.     else ExitToShell();
  329.     
  330. }
  331.  
  332. /* end InitAEStuff */
  333. /* I'm not doing error handling in this sample for clarities sake, you should. Hah, */
  334. /* easy for me to say, huh? */
  335. void DoHighLevel(EventRecord *AERecord)
  336. {
  337.  
  338.     if(noErr != AEProcessAppleEvent(AERecord)){
  339.     /* if it was not an AppleEvent, it must be my HLE.  Since in this sample I send two at once,
  340.     we'll filter for the second one */
  341.     OSErr myErr;
  342.     MyHLEGetter myData;
  343.     OSType theMessageNow ;
  344.     theMessageNow = kSecondEvent;
  345.     /* set up the myData structure for the type of event I sent second */
  346.     myData.whichData = kMessageField;
  347.     myData.specificData = (Ptr)&theMessageNow;
  348.     GetSpecificHighLevelEvent(gGetSpecificFilterUPP,&myData,&myErr);
  349.     }
  350.     
  351. }
  352.  
  353. /* end DoHighLevel */
  354.  
  355. /* This is the standard Open Application event.  */
  356. pascal OSErr AEOpenHandler(AppleEvent *messagein, AppleEvent *reply, long refIn)
  357. {
  358. #pragma unused (messagein,reply,refIn)
  359.     /* we of course don't do anything here in this simple app */
  360.     return(noErr);
  361. }
  362.  
  363. /* end AEOpenHandler */
  364.  
  365. /* Open Doc, opens our documents.  Remember, this can happen at application start AND */
  366. /* anytime else.  If your app is up and running and the user goes to the desktop, hilites one */
  367. /* of your files, and double-clicks or selects Open from the finder File menu this event */
  368. /* handler will get called. Which means you don't do any initialization of globals here, or */
  369. /* anything else except open then doc.  */
  370. /* SO-- Do NOT assume that you are at app start time in this */
  371. /* routine, or bad things will surely happen to you. */
  372.  
  373. pascal OSErr AEOpenDocHandler(AppleEvent *messagein, AppleEvent *reply, long refIn)
  374. {
  375. #pragma unused (reply, refIn)
  376.     /* we of course don't do anything here */
  377.     return(errAEEventNotHandled);                           /* we have no docs, so no odoc events should come to us */
  378. }
  379.  
  380. pascal OSErr AEPrintHandler(AppleEvent *messagein, AppleEvent *reply, long refIn)
  381. {                                                           /* no printing handler in yet, so we'll ignore this */
  382.     /* the operation is functionally identical to the ODOC event, with the additon */
  383.     /* of calling your print routine.  */
  384. #pragma unused (reply,refIn)
  385.     /* we of course don't do anything here */
  386.     return(errAEEventNotHandled);                           /* we have no docs, so no pdoc events should come to us */
  387. }
  388.  
  389. /* Standard Quit event handler, to handle a Quit event from the Finder, for example.  */
  390. /* ••••• DO NOT CALL EXITTOSHELL HERE ••••• or you will never have a happy life.  */
  391. pascal OSErr AEQuitHandler(AppleEvent *messagein, AppleEvent *reply, long refIn)
  392. {
  393. #pragma unused (messagein,refIn)
  394.     
  395.     /* prepQuit sets the Stop flag for us.  It does _NOT_ quit, you */
  396.     /* should NEVER quit from an AppleEvent handler.  Calling */
  397.     /* ExitToShell here would blow things up */
  398.     gQuit = true;
  399.     return(noErr);
  400. }
  401.  
  402.  
  403.  
  404. Boolean BrowseForMe(void)
  405. {Str255 tWext = "\p Find Target Application";
  406. Str255 txWext = "\p apps";
  407.  
  408. return(noErr == PPCBrowser(tWext,
  409.                         &txWext,
  410.                         false,
  411.                         &theLoc,
  412.                         &theRec,
  413.                        nil,
  414.                         nil));
  415.  
  416.  
  417. }
  418.  
  419. /*  Send two high level events */
  420. void SendHLE(void)
  421. {OSErr myErr;
  422. EventRecord eventToSend;
  423. EventRecord eventToSend2;
  424.  
  425. Str255 dataToSend = "\p sample data";
  426. Str255 dataToSend2 = "\p sample data2";
  427. /* search for a target address. */
  428. if(BrowseForMe()){
  429.  
  430.     theID.name = theRec.name;
  431.     theID2.name = theRec.name;
  432. eventToSend.what = kHighLevelEvent;
  433. eventToSend.message = kFirstEvent;
  434. eventToSend.where.h = 'IN';
  435. eventToSend.where.v = 'IT';
  436.  
  437. myErr =PostHighLevelEvent(&eventToSend,(unsigned long)&theID,nil,(Ptr)&dataToSend,(dataToSend[0])+1,receiverIDisTargetID);
  438. eventToSend2.what = kHighLevelEvent;
  439. eventToSend2.message = kSecondEvent;
  440. eventToSend2.where.h = '2M';
  441. eventToSend2.where.v = 'VT';
  442. myErr |= PostHighLevelEvent(&eventToSend2,(unsigned long)&theID2,nil,(Ptr)&dataToSend2,(dataToSend2[0])+1,receiverIDisTargetID);
  443.  
  444. if(myErr)DebugStr("\perr on Post");
  445. }
  446.  
  447.  
  448. }
  449.  
  450. /*
  451. Your filter is specified like as below, with these clarifications to the IM VI words
  452. The data pointer you pass (myData) is COMPLETELY up to you.  It's purpose is to give your
  453. filter the ability to be very generic, you pass it whatever information you need to 
  454. decide if this is the event you want.  My structure for the data in this is, as a sample,
  455. typedef struct MyHLEGetter{
  456. short whichData;
  457. Ptr specificData;
  458. }MyHLEGetter;
  459. The data passed in the HighLevelEventMsgPtr is as follows;
  460. struct HighLevelEventMsg {
  461.  unsigned short HighLevelEventMsgHeaderLength;
  462.  unsigned short version;
  463.  unsigned long reserved1;
  464.  EventRecord theMsgEvent;
  465.  unsigned long userRefcon;
  466.  unsigned long postingOptions;
  467.  unsigned long msgLength;
  468. }; 
  469. so you can examine any of these fields to make a determination about whether to accept the event
  470. or not.  By changing the selector in whichData and the data in specificData, you can tell yourself
  471. to examine any of the fields in the HLE record passed.  
  472. */
  473.  
  474.  
  475. pascal Boolean MyGenericFilter(Ptr myData,HighLevelEventMsgPtr theBuffer,const TargetID *sender)
  476. {
  477. OSType myCheckOSType;
  478. Boolean acceptIt = false;
  479. MyHLEGetter *theSelectionData = (MyHLEGetter *)myData; /* cast for easier reading */
  480. /* so since I may use this many different times, I'd add a switch... */
  481.  
  482. switch(theSelectionData->whichData){
  483.     case kMessageField:
  484.     /* this is the only one I have implemented, tells me that this pass through the */
  485.     /* filter we are looking for an event record that has the message field set to */
  486.     /* the same value as I have in the pointer part of the struct I created and passed */
  487.     /* as myData */
  488.     /* so it's a simple check */
  489.     myCheckOSType = *((OSType *)theSelectionData->specificData);
  490.     if(myCheckOSType == theBuffer->theMsgEvent.message)acceptIt = true;
  491.     break;
  492.     case kRawData:
  493.     break;
  494.     case kRefCon:
  495.     break;
  496.     /* and so on, switching on whatever you need to recognized the event you want. */
  497. }
  498. /* if it is the event I want, then I'll call AcceptHighLevel inside the filter.  */
  499. /* you don't need to do this, you can just return a TRUE and expect the caller of  */
  500. /* GetSpecificHighLevelEvent to do the actual event retreival */
  501. if(acceptIt){
  502.     TargetID sender;
  503.     unsigned long theRefCon;
  504.     Ptr theBuffer = nil;
  505.     unsigned long theLength = 0;
  506.     OSErr myErr;
  507.     
  508.     do{
  509.     myErr = AcceptHighLevelEvent(&sender,
  510.                                   &theRefCon,
  511.                                   theBuffer,
  512.                                   &theLength);
  513.     if(myErr == bufferIsSmall){
  514.     /* small buffer, get the size and do it again */
  515.     theBuffer = NewPtr(theLength);
  516.     } else {
  517.     WindowPtr temp;
  518.     /* move the data into my string display area */
  519.     BlockMove(theBuffer,(Ptr)displayString,theLength);
  520.     GetPort(&temp);
  521.     SetPort(myWindow);
  522.     InvalRect(&myWindow->portRect);
  523.     SetPort(temp);
  524.     break;  /* on any other error, or noErr, exit the thing */
  525.     }
  526.         }while(true);                          
  527.                                   
  528.                                   }
  529. return(acceptIt);
  530. }